home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2002 November / SGI IRIX Base Documentation 2002 November.iso / usr / share / catman / p_man / catD / msgpullup.z / msgpullup
Encoding:
Text File  |  2002-10-03  |  3.3 KB  |  66 lines
  1.  
  2.  
  3.  
  4. mmmmssssggggppppuuuulllllllluuuupppp((((DDDD3333))))                                                    mmmmssssggggppppuuuulllllllluuuupppp((((DDDD3333))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      _mmmm_ssss_gggg_pppp_uuuu_llll_llll_uuuu_pppp - concatenate bytes in a message
  10.  
  11. SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  12.      _####_iiii_nnnn_cccc_llll_uuuu_dddd_eeee _<<<<_ssss_yyyy_ssss_////_ssss_tttt_rrrr_eeee_aaaa_mmmm_...._hhhh_>>>>
  13.      _####_iiii_nnnn_cccc_llll_uuuu_dddd_eeee _<<<<_ssss_yyyy_ssss_////_dddd_dddd_iiii_...._hhhh_>>>>
  14.      _mmmm_bbbb_llll_kkkk______tttt _****_mmmm_ssss_gggg_pppp_uuuu_llll_llll_uuuu_pppp_((((_mmmm_bbbb_llll_kkkk______tttt _****_m_p_,,,, _iiii_nnnn_tttt _l_e_n_))))_;;;;
  15.  
  16.    AAAArrrrgggguuuummmmeeeennnnttttssss
  17.      _m_p        Pointer to the message whose blocks are to be concatenated.
  18.  
  19.      _l_e_n       Number of bytes to concatenate.
  20.  
  21. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  22.      _mmmm_ssss_gggg_pppp_uuuu_llll_llll_uuuu_pppp concatenates and aligns the first _l_e_n data bytes of the message
  23.      pointed to by _m_p, copying the data into a new message.  All message
  24.      blocks that remain in the original message once _l_e_n bytes have been
  25.      concatenated and aligned (including any partial message blocks) are
  26.      copied and linked to the end of the new message, so that the length of
  27.      the new message is equal to the length of the original message.
  28.  
  29.      The original message is unaltered.  If _l_e_n equals -1, all data are
  30.      concatenated.  If _l_e_n bytes of the same message type cannot be found,
  31.      _mmmm_ssss_gggg_pppp_uuuu_llll_llll_uuuu_pppp fails and returns _NNNN_UUUU_LLLL_LLLL.
  32.  
  33.    RRRReeeettttuuuurrrrnnnn VVVVaaaalllluuuueeeessss
  34.      On success, _mmmm_ssss_gggg_pppp_uuuu_llll_llll_uuuu_pppp returns a pointer to the new message.  On failure,
  35.      _mmmm_ssss_gggg_pppp_uuuu_llll_llll_uuuu_pppp returns _NNNN_UUUU_LLLL_LLLL.
  36.  
  37. UUUUSSSSAAAAGGGGEEEE
  38.    LLLLeeeevvvveeeellll
  39.      Base or Interrupt.
  40.  
  41.    SSSSyyyynnnncccchhhhrrrroooonnnniiiizzzzaaaattttiiiioooonnnn CCCCoooonnnnssssttttrrrraaaaiiiinnnnttttssss
  42.      Does not sleep.
  43.  
  44.      Driver-defined basic locks, read/write locks, and sleep locks may be held
  45.      across calls to this function.
  46.  
  47. RRRREEEEFFFFEEEERRRREEEENNNNCCCCEEEESSSS
  48.      _aaaa_llll_llll_oooo_cccc_bbbb(D3), _mmmm_ssss_gggg_bbbb(D4)
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  60.  
  61.  
  62.                                                                         PPPPaaaaggggeeee 1111
  63.  
  64.  
  65.  
  66.